home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbs_soft / sfmagic2.zip / SFMAGIC.DOC < prev    next >
Text File  |  1993-04-18  |  9KB  |  195 lines
  1.  
  2.                     ╔═════════════════════╗
  3.                     ║    SFMAGIC v1.02    ║
  4.                     ╚═════════════════════╝
  5.             
  6.  
  7.          Complete File Management For SPITFIRE BBS Software
  8.                Copyright (C) 1993 by Chris Dingwall
  9.  
  10. DISCLAIMER
  11. ----------
  12. This program and other files associated with it are not guaranteed
  13. to be bug free or virus free.  Chris Dingwall is not responsible
  14. for any damages of any kind, including profit losses and data loss,
  15. that relate directly or indirectly to these programs and files.  
  16.  
  17. DISTRIBUTION
  18. ------------
  19. You may distribute this program, as long as it is in unmodified
  20. form with all the files originally included.
  21.  
  22. WHAT DOES SFMAGIC DO?
  23. ---------------------
  24. SFMAGIC is a comprehensive file management program for SPITFIRE BBS
  25. Software.  This program allows you to:  Add Files/Descriptions;
  26. Edit Descriptions; Move Files; Update File Size/Date; Delete Files;
  27. Mark Files "OFFLINE"; Sort Files; Tag/Untag Files to perform group
  28. functions; etc., etc., etc................. In other words, total
  29. management of your SFFILES.BBS for all file areas.  Multi line file
  30. descriptions for SPITFIRE 3.3 and higher are supported.
  31.  
  32. CD-ROM
  33. ____
  34. YES - CD-ROM is supported!  SFFILES.(xxx) supported automatically if
  35. found in the DISPLAY directory.  Note: E (edit feature) , U (un-
  36. catalog feature), and the sorting are the only commands available when
  37. working on a CD-ROM file area.
  38. IMPORTANT!!!!
  39. If you are running CD-ROM areas, make sure you read the FIXSFCD documentation
  40. included in this archive.  If it doesn't exist, you need to get a new copy 
  41. from one of the BBS's listed below.
  42. If you don't use FIXSFCD, and you needed to, you might be losing some of your
  43. descriptions from your SFFILES!!!!!!
  44.  
  45.  
  46. SPITFIRE Toggles - YES, aware.
  47.  
  48. Supports the first letter capitalization in description if toggled ON in
  49. SPITFIRE.
  50.  
  51. Supports Multi-Line descriptions.  SFMAGIC will read your SF files, and see
  52. how many description lines you have set in SPITFIRE.  If you only have one
  53. line set, SFMAGIC will only let you enter one line, if you have 4, it will
  54. let you enter 4 with word wrap.
  55.  
  56. Supports "Uploaded By" if toggled ON in SPITFIRE.
  57.  
  58. NOTE: SFMAGIC will add the Sysops MESSAGE NAME to the Uploaded By in the file
  59. description.  For example, if you use handles on your board, and your real name
  60. is John Doe, but you use "The Terminator" as your message name (The name that
  61. you log onto your board as, and receive messages to), the description would
  62. read:
  63.  
  64. ANYFILE.ZIP   100,000  03-15-93  Description here..
  65.                                  Uploaded By: The Terminator
  66.  
  67. Limits - only the memory in your particular system.
  68. SFMAGIC will support up to 1000 file areas, with 10,000 files in each area,
  69. however it is limited by the free memory that you have available on your system.
  70.  
  71. REGISTRATION
  72. ------------
  73. This program is NOT CRIPPLED in any fashion!  Also, it does NOT have
  74. any built in delays OR "nag" screens!  You may use this program for
  75. 30 days.  After that period, you must register - no, the program does
  76. NOT "expire" - but, it should be worth $1.00!  Yep, only one buck will
  77. give you a clear conscience!  Mail your check, money order or even
  78. a single greenback to:
  79.                          Chris Dingwall
  80.                          7829 Prescott
  81.                          Plano, TX 75025
  82.  
  83. USAGE
  84. ------
  85. Unzip all files into your SPITFIRE home directory, (usually C:\SF).
  86. Change to that directory and type SFMAGIC.  
  87.  
  88. You will see the Main Menu screen showing all of your file areas. The
  89. cursor may be moved via the arrow keys or PgUp/Dn.  Select the file
  90. area you wish to modify.  Upon selection, you will see that file
  91. area SFFILES.BBS (without header).  This screen is where you will
  92. actually work on your file areas and file descriptions.
  93.  
  94. You can get help from any screen by using the ALT-H Command.
  95.  
  96.  
  97. COMMAND LINE
  98. ------------
  99. SFMAGIC has one command line switch that you can use.  If you type
  100. SFMAGIC /S , SFMAGIC will load, sort all areas, and then quit.  This would
  101. be usefull as a nightly event to sort all your areas, and get that upload
  102. directory into order.
  103.  
  104. Following are the commands and their functions for the different screens:
  105.  
  106. -Select An Area To Work On -
  107.  
  108. Alt-H......... Help
  109. Alt-J......... Shell to DOS or any child program.
  110. Alt-X......... Will end program.
  111. Alt-S......... This will set default sorting preference for each area.
  112.                You can select to sort the area by Size, Date, or Alpha (default)
  113.                Note: This sorting preference is used only for F2 - Sort all
  114.                areas.  When in an area, F2, F3, and F4 still sort by Alpha,
  115.                Date, and Size.  This will create a small file called CONFS.DAT
  116.            in the directory of SFMAGIC.  If you would like to have all
  117.            areas back to the default (alpha), just delete this file.
  118. <ENTER>....... Selects a file area to work on.
  119. Up/Dn Arrow... Moves the highlight bar to different file areas.
  120. F2............ Sorts ALL file areas, and creates a back
  121.                up file you may wish to remove later.
  122.  
  123. -Select A File To Work On -
  124.  
  125. PgUP,PgDn,Home,End,Up/Dn Arrow...Moves the highlight bar.
  126. Alt-H......... Help
  127. Alt-J......... Shell to DOS or any child program.
  128. Space Bar..... Tag and Untag a file.
  129. Alt-T......... Tags all files.
  130. Alt-U......... Untags all files.
  131. Alt-R......... Rename the file in SFFILES AND on the disk.
  132. Alt-E......... Edit the current description one line at a time!  Will allow
  133.            use of Insert, left or right arrows, delete, etc...
  134. Alt-Z......... Insert your BBS ad into .ZIP file.  Note:  For this to work, 
  135.            you MUST have the program RECOM.EXE in your path or the current
  136.            directory.
  137. M............. Move a file (after hitting M you will select the area to
  138.                which you wish to move the file).
  139. Alt-M......... Move ALL tagged files.
  140. D............. Delete a file.
  141. Alt-D......... Delete ALL tagged files.
  142. U............. Uncatalog a file (removes listing from SFFILES.BBS, but  does
  143.                not delete file).
  144. F1............ Resize all files in area. (If a file listed does not exist,
  145.                it will be marked OFFLINE, and if a file is smaller than
  146.            1,000 bytes, a 0, will be added to the size).
  147. F2............ Sorts this area Alphabetically.
  148. F3............ Sorts this area by Date, oldest to newest.
  149. F4............ Sorts this area by File Size, smallest to largest.
  150. F5............ Change the date of the file in the SFFILES. (Not on disk)
  151. F9............ Checks SFFILES listing against files actually on the disk, and
  152.            if a file doesn't exist, asks if you want to uncatalog it.
  153. E............. Edit a file description (Will support as many description lines
  154.                as you have set in your SPITFIRE toggles).
  155. F8............ Checks current directory and will catalog new files
  156.                (will add file(s) to SFFILES.BBS and allow you to enter
  157.                a description.
  158. ESC........... Quit and save (will only prompt you to save if SFFILES.BBS
  159.                has been changed).
  160. Ctrl-U........ Uncatalogs ALL Tagged Files From The SFFILES listing.
  161. --------------------------------------
  162.  
  163. What's Planned?
  164. ---------------
  165. The first thing to do is get this version out and make sure that any bugs found
  166. are squashed.  Ideas for future versions include :
  167.  
  168.         Auto convert any archive style (ZIP,LZH,ARJ)
  169.         Rename the file in SFFILES and on the disk.
  170.         Shell to child program (Editor) or to DOS shell.
  171.         Showing Full description in the files windows.
  172.     Checking to make sure catalogged files exist besides sizing them.
  173.  
  174. These are all I can think of now, but ANY comments or suggestions are welcome!
  175.  
  176. THANKS!
  177. -------
  178. Many thanks go to Rob Dingwall, Paul Staton, Steve Newman, and Rodney Newton
  179. for testing this program and helping me out with problems!
  180.  
  181.  
  182. A little exploring should allow you to become familiar with the
  183. commands.  Thank you for trying SFMAGIC. Comments and/or 
  184. suggestions are always welcome and you may contact the author 
  185. via BBSs listed below. 
  186.  
  187.  
  188.     CastleTree BBS              Robin's Egg BBS
  189.     (214) 517-2895              (214) 964-8726
  190.  Sysop: Chris Dingwall        Sysop: Rob Dingwall
  191.     1200-19200 bps              1200-38400 bps
  192.    (Author's Board)             (Support Board)
  193.  
  194. SPITFIRE Copyright (C) 1987-1993 by Mike Woltz
  195.